Creates a message queue.

OSStatus MPCreateQueue (
    MPQueueID *queue
);

queue

On return, the variable contains the ID of the newly created message queue.

function result

A result code. If a queue could not be created, MPCreateQueue returns kMPInsufficientResourcesErr.

DISCUSSION

This call creates a message queue, which can be used to notify (that is, send) and wait for (that is, receive) messages consisting of three 32-bit words in a preemptively safe manner.

Message queues are created from dynamically allocated internal resources. Other tasks may be competing for these resources so it is possible this function may not be able to create a queue.

See also the functions MPDeleteQueue and MPSetQueueReserve.

VERSION NOTES

Introduced with Multiprocessing Services 1.0.

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when MPLibrary 1.0 or later is installed. Exported by CarbonLib 1.0 and later and by MPLibrary 1.0 and later.

© 2000 Apple Computer, Inc. — (Last Updated 4/6/2000)